home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / prcmv24c.arc / AUTOPRCM.DOC < prev    next >
Encoding:
Text File  |  1986-03-27  |  8.8 KB  |  265 lines
  1.  
  2.  
  3.  
  4.                          AUTOPRCM.BAS (or .EXE)
  5.  
  6.                         Version 1.0 - March 1986
  7.                              J. L. O'Boyle
  8.  
  9.  
  10.      A  routine  to generate DOWNLOAD scripts (.CMD files) for  ProComm* 
  11. version 2.2 and greater.   (It WILL work with version 2.1, but only with 
  12. those file transfer protocols supported by that version.)
  13.  
  14.      This  program was developed after seeing a version originally writ-
  15. ten  by Keith Peterson.   The one I saw had been modified for  use  with 
  16. PIBTERM  and RBBS systems only.   While RBBS is nice,  it's not the ONLY 
  17. Host System in the world!  I've included File Transfer Protocol and Host 
  18. options  for several popular systems.   If the routine is well-received, 
  19. I'll continue to update it as hosts systems (or ProComm) change. 
  20.  
  21. Forward:
  22.  
  23.      One  of the nicest features of ProComm (this authors opinion  only) 
  24. is  it's CMD processor!   CMD files contain,  among  other  things,  the 
  25. keystrokes  you would normally have to enter manually for a given  task.  
  26. The  ProComm documentation covers this subject much more completely  and 
  27. elegantly,  but the "biggies" are the %I statement and the %T statement.  
  28. The  %I  statement says.."wait until these characters are received  from 
  29. the host".   The %T statement says.."send these characters to the host."  
  30. You can see where, with a little expirementation, you could build a file 
  31. to do just about anything you wanted,  provided you KNEW what to  expect 
  32. from the host.
  33.  
  34.      CMD  files  can be built with any editor or  word-processor.   Many  
  35. BBS  systems offer ProComm CMD file examples that will completely  auto-
  36. mate the logon sequence for their particular system.  These need only be 
  37. downloaded and modified for your individual use,  ie; change the sample-
  38. name to YOUR name, etc.
  39.  
  40.      CMD  files can be executed directly from the DOS command line  when 
  41. you execute ProComm.  (Again, please refer to the documentation that Tom 
  42. and  Bruce provide.)  Using this feature,  it's possible to execute  ONE 
  43. DOS  command  which will invoke ProComm,  execute a CMD file which  will 
  44. logon to a given host,  go directly to the <F>iles section,  download  a 
  45. list of the most recent file additions,  logoff the host system, discon-
  46. nect the phone line, print the downloaded list, and exit ProComm.  (I do 
  47. it all the time...and by using the TEF program, I do it in the middle of 
  48. the night when the rates are lower!)
  49.      
  50.      If  you  haven't yet discovered the CMD feature of  ProComm,  maybe 
  51. AUTOPRCM will help you get started!
  52.  
  53.  
  54.                       Operational Considerations:
  55.  
  56.      This  program may be run from WITHIN ProComm,  to produce an  imme-
  57. diate  .CMD file for file transfers.   The BASIC version can be run  via 
  58. the  DOS Shell option (ALT-F4).   I've substituted the compiled  version 
  59.  
  60.  
  61.                                 1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. name for the Editor option in my PROCOMM.PRM.   While on-line to a  sys-
  71. tem,  the ALT-A key sequence initiates the program.  Of course it can be 
  72. run stand-alone anytime!
  73.  
  74.      I suggest that users run the program a few times to become familiar 
  75. with  the files produced.   (AUTOPRCM produces ONE output file per  run, 
  76. called  "DOWNLOAD.CMD")  The .CMD will be activated at different prompts 
  77. depending  on the host system.   Once you know what the FIRST command in 
  78. the  file does,  you'll only have to get to the requisite prompt on  the 
  79. host system and trigger the .CMD file via ProComms' ALT-F5 key sequence.
  80.  
  81.      It's recommended that .CMD files,  created via AUTOPRCM, NOT be run 
  82. in an unattended mode!   A misspelling of a file name and/or changes  in 
  83. host  prompts may cause the .CMD to WAIT on an unexpected prompt.   With 
  84. that in mind, it also might be a good idea to set your "%P" parameter to 
  85. a low value.   The .CMD may recover and continue.  If a .CMD file hangs, 
  86. the ESC key will return you to manual control.
  87.  
  88.      It's  also  recommended that you have a copy of the  host  download 
  89. directory handy when you create your .CMD file,  or at least good  clear 
  90. notes if you're running the program dynamically.  Scan the host directo-
  91. ries  for the files you want,  make a list of those files,  and USE  the 
  92. list when you are running AUTOPRCM.
  93.  
  94.      Protocols  which provide FILESPEC data,  such as Kermit and  Ymodem 
  95. Batch,  don't lend themselves to sub-directory specification.   The Pro-
  96. Comm  commands for these protocols have no provision for the addition of 
  97. a sub-directory string.   Unless otherwise specified,  files  downloaded 
  98. using  these  protocols will be written to your  default  directory.   A 
  99. work-around  is to have the DOWNLOAD.CMD file itself in a sub-directory, 
  100. log  to that sub-directory via the ProComm ALT-B command,  and  run  the 
  101. DOWNLOAD.CMD from there.   This applies to Kermit,  Ymodem Batch, Telink 
  102. and Modem7.
  103.  
  104.                    Minimal notes on supported hosts.
  105.  
  106. RBBS
  107.            - Currently  only provides Xmodem protocol.   (ASCII was  not 
  108.           included  in  AUTOPRCM since most useful files are not  stored 
  109.           in  that form.)  Since RBBS allows the download  command,  the 
  110.           file  name,  and  the  protocol option to be specified  via  a 
  111.           single string, (ie; "D;ANYFILE.BAS;X") the "DOWNLOAD.CMD" file 
  112.           begins with this command.  
  113.  
  114. IBBS
  115.           - The above notes from RBBS apply here also.
  116.  
  117. Exec-PC 
  118.           - See RBBS or IBBS.
  119.  
  120. Source IBMSIG 
  121.           - The  only  protocol currently available is  Sliding  Windows 
  122.           Kermit.  This .CMD starts from the "Enter File Name" prompt.
  123.  
  124. PC-Board  
  125.  
  126.  
  127.                                 2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.           - The  transfer  protocol you use from a  PC-Board  system  is 
  137.           contained in your PC-Board user profile.   Be certain that the 
  138.           one  you choose for AUTOPRCM matches that used in the PC-Board 
  139.           system  you contact.   This .CMD starts from the  "Enter  File 
  140.           Name" prompt.  
  141.  
  142. FIDO  
  143.           - Prompts  and  protocols for FIDO systems are in a  state  of 
  144.           flux.   AUTOPRCM supports Xmodem,  Kermit, Telink, and Modem7.  
  145.           It  has been tested successfully with the PIL Software Systems 
  146.           FIDO  node.   This  .CMD  starts from the  "Enter  File  Name" 
  147.           prompt.
  148.  
  149. PC-HOST  
  150.           -  These  systems do not use filenames for  security  reasons.  
  151.           Files are selected via number from a directory list.  AUTOPRCM 
  152.           will BEGIN with a directory change command,  and continue from 
  153.           there.  For Kermit and Ymodem Batch, only the Dir # and File # 
  154.           must be specified.   For Xmodem amd Ymodem,  the addition of a 
  155.           file name is required.  
  156.  
  157. CRC-16 verification will be always be utilized where available.
  158.  
  159.  
  160.      Some Variable Names.......(if you want to make modifications.)
  161.  
  162.  Q$   - Really a double quote, but no other way to get it into a string.
  163.  RD$  - Contains "Ready for Download" string for a given host.
  164.  RT$  - Contains "Ready to Transmit" string for a given host.
  165.  RP$  - Contains ProComm Xfer protocol trigger string.
  166.  DF$  - Contains a DEFAULT "DRV:SUBDIR" for captured files.
  167.  SD$  - A settle-delay value.  Needed for some systems.  It's the %W"n"!
  168.  PR$  - Contains the Protocol Request Message for the a given host.
  169.  RPR$ - Contains the Protocol Request Response for the appropriate host.
  170.  RFN$ - Contains the "Request for Filename" string for the a given host.
  171.  DR$  - Contains your SELECTED "DRV:SUBDIR" string.
  172.  
  173.  
  174.  
  175. If you find that this program is useful to you,  a contribution  (coupla 
  176. bucks) would be appreciated, and can be mailed to:
  177.  
  178.                           John L .O'Boyle
  179.                           PO Box 10596
  180.                           West Hartford, CT   06110
  181.  
  182. Since  this  code  is useless without PROCOMM,  please be  certain  that 
  183. you've  also supported THAT product via contribution!   If it gets to  a 
  184. choice between me and them, please send THEM your money!
  185.  
  186.  
  187.                The usual disclaimer applies to AUTOPRCM.   NO 
  188.                WARRANTIES EXPRESSED OR IMPLIED!
  189.  
  190.  
  191.  
  192.  
  193.                                 3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203. * PROCOMM  
  204.  
  205. V2.3 Copyright 1985, 1986 PIL Software Systems, Bruce Barkelew & Tom Smith   
  206.                                                                           
  207.                           PIL Software Systems                               
  208.                           P.O. Box 1471                                      
  209.                           Columbia, MO  65205                                
  210.                                                                       
  211.  ProComm support BBS  (314) 449-9401  23 hrs per day, 4 00 - 3 00 am CST.    
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                 4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.